Ficha técnica

Seguridad

📘 BTG Id

El Authorization Server de BTG Empresas se llama BTG Id. Usando el BTG Id, una aplicación partner obtiene consentimiento y autorización para ejecutar operaciones en las APIs de BTG en nombre del cliente. Para saber más, acceda a la documentación del BTG Id

Alcances necesarios

El token para consumir la API de Crédito Solar debe generarse utilizando el Client Credentials.

Es necesario elegir uno de los siguientes alcances:

Alcance	Descripción
empresas.btgpactual.com/solar-credit	Permite enviar pre-análisis y consultas, incluyendo de integrador/distribuidor.
empresas.btgpactual.com/solar-credit.readonly	Permite enviar solo pre-análisis y consultas de integrador/distribuidor.

Eventos de webhook

Los payloads disponibles a continuación representan el contenido del campo data.

Evento	Descripción
credito-solar.analyzed	Crédito analizado
credito-solar.changed-status	Cambio en el estado del análisis

credito-solar.analyzed

{
    "taxId": "00000000000",
    "effectiveness": "PreApproved",
    "productLimit": 50000.0,
    "limitDateExpire": "2024-03-13T00:00:00",
    "product": "Solar",
    "approvedPaymentTerms": [
        {
            "gracePeriod": 3,
            "installmentsMin": 96,
            "installmentsMax": 96,
            "monthlyRate": 0.0162,
            "yearRate": 0.21,
            "monthCet": 0.02,
            "yearCet": 0.22,
            "amount": 130000.0,
            "instalmentAmount": 1350.0
        }
    ],
    "originId": "93806596-15dd-4b80-a222-73deeb70d519",
    "description": "O valor das parcelas mensais é estimado e poderá variar conforme data de assinatura do contrato de empréstimo, bem como da data escolhida para pagamento das prestações.\nA liberação dos recursos estará condicionada à prévia concordância dos termos do financiamento entre as partes e negociação e preparação de toda a documentação necessária em condições satisfatórias ao BTG Pactual, bem como da análise cadastral completa do Cliente e da perfeita formalização das garantias.\nA presente proposta é válida pelo prazo de 5 (cinco) dias úteis contados da presente data."
}

credito-solar.changed-status

{
    "taxId": "00000000000",
    "status": "DocumentsAnalysis",
    "originId": "93806596-15dd-4b80-a222-73deeb70d519",
    "occurrenceDate": "2023-12-11T16:26:29.072171",
    "productType": "Solar"
}

Estados posibles:

Descripción	Estado Anterior	Estado Nuevo
Esperando análisis interno de los datos de registro	EM_CADASTRO	AccountCreationAnalysis
Los datos de registro fueron pendenciados, es necesario ajustar la información	EM_CADASTRO	AccountCreationDataAdjustment
Apertura de cuenta rechazada	DOCUMENTOS_REJEITADOS	AccountCreationDisapproved
La propuesta expiró en la etapa de apertura de cuenta	VENCIDO	AccountCreationExpired
Iniciando apertura de cuenta del cliente	EM_CADASTRO	AccountCreationStartingOnboarding
Pendiente envío del formulario de datos de registro	EM_CADASTRO	AccountCreationPendingSubmit
Pendiente firma del término de apertura de cuenta	EM_CADASTRO	AccountCreationWaitingSignatures
Valor del crédito desembolsado	CONCLUIDO	ContractingOperationDisbursed
Esperando contratación del crédito por parte del cliente	AGUARDANDO_DESEMBOLSO	ContractingWaitingOperation
Operación contratada, esperando desembolso del crédito	AGUARDANDO_DESEMBOLSO	ContractingWaitingDisbursement
Esperando firmas para liberación del crédito	AGUARDANDO_DESEMBOLSO	ContractingWaitingSignatures
La propuesta fue rechazada en la etapa de contratación	DOCUMENTOS_REJEITADOS	ContractingDisapproved
La propuesta expiró en la etapa de contratación	VENCIDO	ContractingExpired
Esperando análisis interno de los documentos de comprobación	ANALISE_DOCUMENTACAO	DocumentsAnalysis
Los documentos fueron pendenciados, es necesario ajustar la información	AJUSTE_DOCUMENTACAO	DocumentsDataAdjustment
La propuesta expiró en la etapa de envío de documentos	VENCIDO	DocumentsExpired
Pendiente envío de los documentos de comprobación de la información de la propuesta	PENDENTE_DOCUMENTACAO	DocumentsPendingSubmit
Los documentos fueron rechazados	DOCUMENTOS_REJEITADOS	DocumentsDisapproved
La propuesta expiró en la etapa de análisis final de crédito	VENCIDO	FinalProposalExpired
Propuesta de crédito disponible para aceptación del cliente	AGUARDANDO_ACEITE	FinalProposalPendingAccept
Esperando análisis interno de las facturas fiscales	ANALISE_DOCUMENTACAO	InvoicesAnalysis
Las facturas fiscales fueron pendenciadas, es necesario ajustar la información	AJUSTE_DOCUMENTACAO	InvoicesDataAdjustment
La propuesta expiró en la etapa de envío de facturas fiscales	VENCIDO	InvoicesExpired
Pendiente liberación del límite del integrador para que la propuesta fluya	N/A	InvoicesPendingLimitAvailability
Pendiente envío de las facturas fiscales para análisis	ENVIO_NFE	InvoicesPendingSubmit
Las facturas fiscales fueron rechazadas	DOCUMENTOS_REJEITADOS	InvoicesDisapproved
Esperando análisis de crédito interno	EM_ANALISE	LeadViabilityAnalysis
La propuesta expiró en la etapa de análisis de viabilidad	VENCIDO	LeadViabilityExpired
Pendiente envío de la información básica para la solicitud de crédito	FORMULARIO_PREENCHIMENTO	LeadViabilityPendingSubmit
Pendiente ajuste de la información básica para la solicitud de crédito	FORMULARIO_PREENCHIMENTO	LeadViabilityDataAdjustment
Propuesta rechazada por crédito	REPROVADO_MOTOR	LeadViabilityDisapproved